home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _utilities / utilities / 004 / _fliplay / !FliPlay / !Help < prev    next >
Text File  |  1994-10-15  |  7KB  |  163 lines
  1. !FLIPlay 0.27, 15th October 1994
  2. ================================
  3.  
  4. #include <std/disclaimer.h>
  5. FLIPlay is copyright ⌐ 1994 K.F.Quinn.  It is distributed in good faith,
  6. but without any warranty, even without any implied warranty of
  7. merchantability or fitness for a particular purpose.
  8.  
  9. FLIPlay 0.27 is free.  No charge may be made for the software itself,
  10. however reasonable charges may be made to cover handling, distribution
  11. and media costs.
  12.  
  13. Comments, suggestions and bug reports to fliplay@banana.demon.co.uk.
  14.  
  15.  
  16. Credits:
  17.   Simon Middleton for hints, bug reports, corrections, RiscPC stuff and
  18. general encouragement.
  19.  
  20.  
  21. --------------------------------------------------------------------------
  22.  
  23.  
  24. Introduction
  25. ============
  26.  
  27. This little utility plays standard Autodesk Animator FLI and Animator Pro
  28. FLC files.
  29.  
  30. Note that under Risc OS 2 the player only supports FLI files and only
  31. supports the standard 256-colour (16-palette) modes.  
  32.  
  33. Under Risc OS 3 however it will play FLI and FLC files, and automatically
  34. finds the best available screen mode, and should detect graphics
  35. enhancement cards if they integrate properly with Risc OS.  Where 256-entry
  36. palettes are available these will be used if possible.  It also corrects
  37. properly for the 6x5 aspect ratio on FLI files.
  38.  
  39. Under Risc OS 3.5 (i.e. on the Risc PC) the player finds a 256-entry
  40. palette mode that is most appropriate - this gives true SVGA colour.
  41.  
  42. For the rest of this document, where FLI files are mentioned, it should
  43. be taken to mean FLI or FLC files.
  44.  
  45.  
  46.  
  47. Instructions
  48. ============
  49.  
  50.  
  51. 1) Loading FLIPlay and Starting Animations
  52.    ---------------------------------------
  53.  
  54. Double-click on the !FLIPlay icon or a file with filetype FLI (&B9F) to
  55. load FLIPlay.
  56.  
  57. When the application is loaded, click select on the iconbar icon to
  58. see the FLI (if appropriate).  Double-clicking on a FLI file when the
  59. application is already loaded automatically runs the animation.  Once
  60. loaded, the application will attempt to play files ending in "/FLI" or
  61. "/FLC" as well as those of filetype FLI.  Clicking select on the iconbar
  62. will play the last FLI loaded.
  63.  
  64. Note: If FLIPLay fails to pick up double-clicks properly, and insists on
  65. launching a second copy of itself, then the filer has probably "seen" an
  66. old version of !FliPlay.  If this has happened, type "Unset File$Type_301"
  67. at a command line prompt (press F12, type in the line then press return
  68. again).  It is probably a good idea to delete the old version so that it
  69. won't be seen by the filer again.
  70.  
  71.  
  72. 2) The Iconbar Menu
  73.    ----------------
  74.    
  75. The iconbar menu allows some control over the display of animations.
  76. The "Options" submenu has the following items, all of which may be
  77. turned on and off:
  78.  
  79.   Display Text:  For each frame, the frame number and the amount of
  80.                  time taken to process the frame (in centiseconds) is
  81.                  shown at the bottom of the display.  The time delay
  82.                  does not include the time taken to load the frame
  83.                  from disc (if relevant).
  84.                  Default: Off.
  85.  
  86.   Override Chk:  This stops FLIPlay from discarding files that don't
  87.                  come up to certain criteria.  The checks include
  88.                  the file "magic number" and that the depth of pixels
  89.                  is 8bpp.  I have seen a few FLIs which say they don't
  90.                  meet the 8bpp requirement, even though they do.  If
  91.                  you have one of these files, select this option and
  92.                  FLIPlay will attempt to play as normal.  Default: Off.
  93.            Note: If this option is selected and a file that is NOT a
  94.                  FLI is dragged to the icon bar then the action of the
  95.                  player is undefined, and could cause your machine to
  96.                  crash.  Use with caution.
  97.  
  98.   Grid Aspect:   This option causes FLIPlay to rationalise the aspect
  99.                  ratio of animations.  This is particularly useful for
  100.                  old-style FLIs which have small sized text in their
  101.                  frames.  Old-style FLIs have an aspect ratio of 6:5
  102.                  which leads to problems when displaying on a screen
  103.                  whose aspect ratio is 1:1, 1:2, 2:1 etc.  If this
  104.                  option is selected then the aspect ratio is adjusted
  105.                  to one that fits more easily.  This means that the
  106.                  animation gets squashed or stretched somewhat, but
  107.                  the display is cleaner (and often quicker).
  108.                  Default: On.
  109.  
  110.   Resolution:    This option has a submenu which lists all the suitable
  111.                  screen resolutions found by FLIPlay, along with an item
  112.                  "Auto".  If "Auto" is ticked, then FLIPlay will try to
  113.                  find a best-fit screen resolution, picking the nearest size
  114.                  greater than or the same as that of the FLI being played.
  115.                  An individual resolution may be ticked instead of Auto,
  116.                  in which case FLIPlay will use the selected resolution.
  117.                  This is particularly useful for users with VGA monitors
  118.                  for example, or for times when the automatic selection
  119.                  picks an unsuitable screen resolution.  On the Risc PC,
  120.                  the frame rate is displayed as well as resolution.  On
  121.                  other machines the old-style 16-palette modes are marked
  122.                  as "low colour".
  123.                  Default: Auto.
  124.  
  125.  
  126. 3) Facilities while Playing
  127.    ------------------------
  128.  
  129. The following keys are detected by FLIPlay.  The keyboard is checked
  130. between frames, so to have any effect a key must be held down for at
  131. least one frame.
  132.  
  133.   Key    | Action
  134.   -------+-------------------------------------
  135.   Shift  | Speed up animation
  136.   Ctrl   | Slow down animation
  137.   Space  | Pause/Release animation
  138.   Escape | Stop animation and return to desktop
  139.  
  140. Note that on the Risc OS 2 version, "Escape" has no effect, and "Space"
  141. causes the animation to terminate next time it reaches the end of the
  142. sequence.
  143.  
  144.  
  145. 4) Comments about File Loading
  146.    ---------------------------
  147.  
  148. The player attempts to read the whole file into main memory; however
  149. if this is not possible then the file is loaded frame by frame.  Memory
  150. that is grabbed during playback is released back to the system when
  151. the animation is stopped.  Obviously the playback will be quicker if the
  152. whole animation can be loaded - try to make sure you have enough memory
  153. in the "Free" and "Next" slots in the task display to hold the animation.
  154.  
  155.  
  156. 5) The FLI filetype
  157.    ----------------
  158.  
  159. The FLI filetype is &B9F.  If you have any FLI files that are filetyped
  160. to anything else, they should be changed (an older release of
  161. FLIPlay used another type).  Filetype &B9F has been properly allocated
  162. to FLI files by Acorn Computers Ltd.  The filetype also covers FLC files.
  163.